home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 011 / utilhard.arc / SDIR5.DOC < prev    next >
Encoding:
Text File  |  1985-03-20  |  7.8 KB  |  203 lines
  1.  
  2. ----------------------------------------------------------------
  3.        SDIR -[SUPER-DIRECTORY] COMMAND, Version 5.0
  4. ----------------------------------------------------------------
  5.  
  6.       An All-purpose Directory Utility and Command Shell for
  7.          the IBM Personal Computer
  8.  
  9.          By W. Lawrence Hatt
  10.  
  11. Copyright (c) 1984 by W. Lawrence Hatt. All rights reserved.
  12.  
  13.  
  14.  
  15. SDIR VERSION 5.0 is currently distributed as User Supported
  16. Software.  With a few restrictions, this allows the
  17. program, although copyrighted, to be freely copied and
  18. distributed.
  19.  
  20. SDIR 5.0 is a major update of the program SDIR 4.0/4.1
  21. previously distributed free.  The update corrects existing
  22. bugs and adds a major new feature: COMMAND MODE.  This mode
  23. allow ready access to usual file actions such as DEL, COPY,
  24. LOOK (list to screen), change attributes and execute
  25. programs.  Since I find the directory a useful base of
  26. normal operation, fast menu-like use of the directory as a
  27. shell for these operations is very convenient.
  28.  
  29. This product must be copied and distributed as a complete
  30. package.  This includes both the SDIR 5.0 program
  31. (SDIR50.COM) and this documentation file (SDIR50.DOC). 
  32. SDIR 5.0 is copyrighted and may not be distributed if
  33. altered or modified in any way.  Finally, no fee is to be
  34. charged for copying or distributing the programs without my
  35. written permission.
  36.  
  37. In short, SDIR 5.0 may be copied and distributed to anyone
  38. who wishes it as long as it is a complete unmodified
  39. package including the program and documentation and no fee
  40. is charged.  In turn, I am requesting a small contribution;
  41. about $10.00 is suggested but please contribute whatever
  42. you feel the program is worth.  Your contributions will
  43. help offset development costs and thus assure future
  44. updates and products.  Also, registered users of SDIR 5.0
  45. will be placed on a mailing list for future modifications. 
  46. Even if you don't feel that the program merits a
  47. contribution, please continue to copy and share this
  48. program with others.
  49.  
  50.  
  51.                               W. Lawrence Hatt
  52.                               76 Melville Drive
  53.                               Nepean, Ontario
  54.                               Canada, K2J 2E1
  55.  
  56.  
  57. REQUIRED CONFIGURATION
  58.  
  59.         * IBM PC or close clone
  60.         * Color Graphic or IBM Mono screen adapter
  61.         * DOS 2.0 or 2.1
  62.         * 128k or more for COMMAND MODE
  63.  
  64. USING SDIR VERSION 5.0
  65.  
  66. SDIR [d:][path][filename[.ext]] [options]                              
  67.      [filespec] same as for DIR command
  68.  
  69.      [options]   /A - List hidden files.
  70.                  /C - Single Column Commented Directory.           
  71.                       (see explanation below)
  72.                  /X - Sort by extension.
  73.                  /S - Sort by size.
  74.                  /D - Sort by date/time.
  75.                  /N - Do not sort, original order.
  76.  
  77. COMMAND [/] - To invoke command actions on selected
  78.     file after the directory is up: LOOK at any ASCII or
  79.     WORDSTAR file; Execute (GO) any COM, EXE or BAS file;
  80.     Set or Reset Archive or Read-only file attribute; Copy
  81.     to drive A:,B:,C:, or D:; Delete any file; Copy any
  82.     complete directory to the default directory on the
  83.     indicated drive.
  84.  
  85. DEFAULT    - *.* sorted by name.ext. 
  86.   
  87. NOTE       - Non conflicting Options may be combined.
  88.        i.e.  sdir/c/a/d is a valid option. 
  89.  
  90.       - It is suggested that SDIR50.COM be renamed D.COM and
  91.       remain on all system diskettes or the default path
  92.       directory of your hard disk.
  93.  
  94. /C  THE COMMENTED DIRECTORY
  95.         
  96. The directory is listed in one column only; use PgUp/ PgDn
  97. to page through any number of pages.  A file SDIR.$$$ is
  98. either created or opened and sorted with comments appearing
  99. beside the appropriate file.  This file is stored on the
  100. default disk/directory no matter where the SDIR command
  101. file resides.  The real directory is not touched of course. 
  102. In fact, although each whole file line is stored, only the
  103. last 40 characters are written to the screen.  Thus,
  104. progressive updates of the same file will keep the same
  105. comments.  The comments for deleted files will
  106. automatically be deleted.  Unfortunately, if you change the
  107. filename the comments are lost for that file.
  108.  
  109. Primitive edit control is available to write new comments:
  110.             - normal upper and lower case characters
  111.             - RTN: jump to beginning of next line
  112.             - DEL and BKSP: distructive cursor left
  113.             - CURSOR: control keys work normally
  114.             - PgUp and PgDn: normal
  115.     
  116. SDIR50 is compatible with comment files from SDIR40,
  117. SDIR401, SDIR41 AND SDIR411.
  118.  
  119. ESC: must use this key to return to DOS or return to normal
  120. mode from the COMMAND mode.
  121.  
  122. [/]  THE COMMAND MODE
  123.  
  124. Command Mode is available at any time after invoking the
  125. SDIR program by keying "/" (like 123).  When this is done a
  126. double command line appears at the top of the screen and
  127. individual commands are invoked by placing the cursor on
  128. the desired action file.  The desired action is invoked by
  129. striking the highlighted key for the desired action. 
  130. Available actions include the following:
  131.  
  132. CHANGE ATTRIBUTE
  133.     
  134.     R - change file to Read-Only, or if already
  135.         Read-only to Read-write
  136.     A - change the Archive bit
  137.  
  138. In either case the state of all attributes are displayed
  139. for the file regardless of whether the /A mode was
  140. initially selected.
  141.  
  142. GO
  143.  
  144. This is the program execute key.  Selected file must be
  145. .COM, .EXE, or .BAS.  Your machine should have extra memory
  146. since the SDIR program and buffers stay resident using up
  147. about 64k of memory.
  148.  
  149. There are two other important requirements for full
  150. function of this mode.  A copy of COMMAND.COM and
  151. BASICA.COM must be resident on the ROOT DIRECTORY of the
  152. default drive.  The COMMAND.COM version must be the same
  153. as the one used at boot-up time or the system will
  154. `hang'.  For hard disk users you probably already keep
  155. COMMAND.COM and BASICA.COM on the `\' directory of C:; 
  156. for floppy diskette use, I'm afraid you'll need compatible
  157. COMMAND.COM on each diskette you are copying from---this
  158. problem arises because the program must know exactly where
  159. to find COMMAND.COM as we load a secondary copy to use in
  160. the EXEC function call and the COPY command.
  161.  
  162. If you want to have some fun try repeated re-execution of
  163. the SDIR program using GO.
  164.  
  165. DELETE
  166.  
  167. The selected file is deleted.  Be careful, there's no going
  168. back.  An X is indicated on the right side of the file to
  169. remind of action taken.
  170.  
  171. LOOK
  172.  
  173. This is a quick, screen-oriented, file lister.  Paging
  174. control is provided but no editing.  Files are expected
  175. to be ASCII but WordStar and other similar wordprocessing
  176. files are handled by interpreting only the lower 7 bits of
  177. the code and a few other extraneous WordStar characters are
  178. removed.  "Looking" at other files may produce "junk" on
  179. the screen.  The listing ends with the encounter of ASCII
  180. 254.  The file size is limited to the balance of the 64 k
  181. segment occupied by SDIR; this usually amounts to about 20k
  182. character files.
  183.  
  184. COPY
  185.  
  186. Hitting the appropriate number copies the selected file to
  187. the indicated drive.  Appropriate error messages will
  188. indicate any problems.  Placing the cursor on a directory
  189. entry copies the whole directory.  As for the GO command
  190. you must have a copy of COMMAND.COM on the ROOT DIRECTORY
  191. of the default drive to use COPY.  The version must be the
  192. same as the version used to boot the system.
  193.  
  194. IMPORTANT NOTE: THE OBJECT FILES POINTED TO BY THE CURSOR
  195. MUST BE ON THE DEFAULT DRIVE/DIRECTORY.  AN ERROR NOTICE
  196. WILL BE GIVEN FOR OTHER FILES.  THIS MEANS,FOR INSTANCE,
  197. THAT YOU CANNOT INVOKE COMMAND ACTIONS AFTER INVOKING "SDIR
  198. A:" FROM THE DEFAULT B: DRIVE.
  199.  
  200. Direct comments or problems to Larry Hatt on PCANADA PC1269
  201. or write to the above address.  
  202. END OF TRANSFER - PRESS ENTER TO RETURN TO MENU
  203.